table of contents
LTTNG-UST-DL(3) | LTTng Manual | LTTNG-UST-DL(3) |
NAME¶
lttng-ust-dl - Dynamic linker tracing (LTTng-UST helper)
SYNOPSIS¶
Launch your application by preloading liblttng-ust-dl.so:
LD_PRELOAD=liblttng-ust-dl.so my-app
DESCRIPTION¶
When the liblttng-ust-dl.so library is preloaded before a given application starts, it causes all calls to dlopen(3) and dlclose(3) in said application to be traced with LTTng-UST (see lttng-ust(3)).
See lttng(1) to learn more about how to control LTTng tracing sessions.
The following LTTng-UST events are available when using this library:
lttng_ust_dl:dlopen
Fields:
Field name | Description |
baddr | Base address of loaded library |
memsz | Size of loaded library in memory |
path | Path to loaded library file |
lttng_ust_dl:dlclose
Fields:
Field name | Description |
baddr | Base address of loaded library |
lttng_ust_dl:debug_link
Fields:
Field name | Description |
baddr | Base address of loaded library |
filename | Debug link file name |
crc | Debug link file’s CRC |
lttng_ust_dl:build_id
Fields:
Field name | Description |
baddr | Base address of loaded library |
build_id | Build ID |
BUGS¶
If you encounter any issue or usability problem, please report it on the LTTng bug tracker <https://bugs.lttng.org/projects/lttng-ust>.
RESOURCES¶
COPYRIGHTS¶
This library is part of the LTTng-UST project.
This library is distributed under the GNU Lesser General Public License, version 2.1 <http://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html>. See the COPYING <https://github.com/lttng/lttng-ust/blob/master/COPYING> file for more details.
THANKS¶
Thanks to Ericsson for funding this work, providing real-life use cases, and testing.
Special thanks to Michel Dagenais and the DORSAL laboratory <http://www.dorsal.polymtl.ca/> at École Polytechnique de Montréal for the LTTng journey.
AUTHORS¶
LTTng-UST was originally written by Mathieu Desnoyers, with additional contributions from various other people. It is currently maintained by Mathieu Desnoyers <mailto:mathieu.desnoyers@efficios.com>.
SEE ALSO¶
lttng-ust(3), dlopen(3), lttng(1)
06/05/2016 | LTTng 2.9.0-pre |